home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / maxjm110.zip / MAXJM110.DOC < prev   
Text File  |  1991-05-20  |  4KB  |  85 lines
  1.  
  2.  
  3.                   ┌─────────────────────────────┐
  4.                   │  MAXJM a JModem Interface   │
  5.                   │       MAXIMUS / OPUS        │
  6.                   └─────────────────────────────┘
  7.  
  8.                            Version 1.10
  9.  
  10.                       Written by Ray Kaliss of
  11.                         1:141/840fidonet.org.
  12.                      Hacked on by Randy Edwards
  13.  
  14.  
  15.  
  16. First off, there's no guarantees of any kind with this software.  Use it at
  17. your own risk!
  18.  
  19. Here is a JModem interface for OPUS and MAXIMUS compatible BBS systems.  The
  20. other JModem interfaces I tried didn't work for me ... so I wrote my own that
  21. did work for me ... maybe it will work for you.
  22.  
  23. Install JModem into MAX as an external Protocol.  Note: JModem is a single
  24. file transfer protocol, so make sure not to install it as a Maximus "batch"
  25. protocol.  Have the EXE called be this one -- MAXJM.EXE.  MAXJM must be named
  26. exactly that in order to work.
  27.  
  28. In operation: when MAX drops out ... it will write MAXJM.CTL ... which
  29. MAXJM.EXE will read ... then it will call JMBATCH.* and pass it the proper
  30. info.  JMBatch in turn calls the real JMODEM protocol.  MAXJM.LOG is created
  31. if the file transfer was successful so MAX can update the appropriate
  32. statistics.
  33.  
  34. If anything goes wrong, MAXJM returns several various DOS errorlevels.  Though
  35. these are hard or impossible to trap inside of Maximus or Opus, they're useful
  36. for fixing a problem in a 'standalone' mode from DOS.
  37.  
  38. ErrorLevel returned           Meaning
  39.  
  40.   255 = Bad parameter passed. Programmer's error that should never happen.
  41.         Contact the author if it does.
  42.  
  43.   254 = Error reading MaxJM.CTL file created by Maximus/Opus.  Unlikely to
  44.         happen.  If it does happen, something has corrupted the MAXJM.CTL file
  45.         or the file is in the wrong format.
  46.  
  47.   253 = Unspecified error while doing the DOS shell.  Out of memory probably,
  48.         perhaps couldn't find COMSPEC variable, etc.
  49.  
  50.   252 = Error opening MaxJM.CTL file -- i.e. file not found.  An error here
  51.         would point to a BBS installation problem.
  52.  
  53.     1 = Everything went okay except the JModem file transfer aborted.
  54.         Trivial, can be ignored as MAXJM and the BBS will take care of it.
  55.  
  56.     0 = All successful.  Successful shell to JMBatch.* done and file was
  57.         transferred successfully.
  58.  
  59.  
  60. See the sample JMBATCH file and edit it to suit yourself.
  61.  
  62. Notes about JMBATCH:  JMBATCH is the file that actually calls the JMODEM file
  63. transfer program.  MAXJM will pass JMBATCH two parameters: first, a S or R to
  64. tell JModem whether it's receiving or sending, and secondly the filename it is
  65. to send or receive.  Simple, eh?
  66.  
  67. JModem creates no log files itself.  In order to tell whether a file transfer
  68. is successful or not, JModem returns a DOS errorlevel.  The JMBATCH file
  69. should "trap" or detect this errorlevel.  If an errorlevel is returned a file
  70. called MAXJM.FLG (the FLG for 'flag') should be created.  MAXJM will check for
  71. the MAXJM.FLG file created by an aborted file transfer and act accordingly.
  72. MAXJM will then delete the MAXJM.FLG file automatically.
  73.  
  74. If you don't bother to go to the trouble of trapping JModem for an aborted
  75. transfer and never make any MAXJM.FLG file, then MAXJM won't mind at all -- it
  76. will just think that every file transfer was successful.  Of course your users
  77. who are charged download credits for aborted file transfers might be a little
  78. annoyed at this. <grin>
  79.  
  80. Hey ... it works for me.
  81.  
  82.  
  83.  
  84.  
  85.